home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 11 / Cream of the Crop 11-2.iso / os2 / gnucal.zip / gcal-de.info-1 (.txt) < prev    next >
GNU Info File  |  1995-12-20  |  32KB  |  621 lines
  1. This is Info file ./gcal-de.info, produced by Makeinfo-1.63 from the
  2. input file ./doc/tex/gcal-de.texi.
  3. Diese Datei beschreibt Gcal, ein Programm um Kalender auszugeben.  Gcal
  4. gibt Monatskalender und Jahreskalender, ewige Feiertagslisten sowie
  5. Terminwarnungslisten auf viele verschiedene Arten und Weisen aus.  Es
  6. ber"ucksichtigt diejenigen Daten korrekt, welche "ubergangen wurden,
  7. als der derzeitig g"ultige Gregorianische Kalender den vormals g"ultigen
  8. Julianischen Kalender abl"oste.
  9. Copyright (C) 1994, 1995 Thomas Esken
  10. Das ist die erste Auflage der Gcal Dokumentation.
  11. Hiermit wird die Erlaubnis erteilt, wortgetreue Kopien dieses Handbuches
  12. zu erstellen und zu vertreiben, sofern alle gemachten Kopien mit dem
  13. Copyrightvermerk und diesem Genehmigungsvermerk ausgestattet sind und
  14. vorgenannte Vermerke erhalten bleiben.
  15. Hiermit wird die Erlaubnis erteilt, ver"anderte Kopien dieses Handbuches
  16. wie unter den Bedingungen f"ur wortgetreue Kopien zu erstellen und zu
  17. vertreiben, sofern die ausgef"uhrten Arbeiten in Ableitung und
  18. Gesamtheit innerhalb der Bestimmungen eines Genehmigungvermerks liegen
  19. und zudem mit diesem ausgestattet sind, welcher mit diesem hier
  20. identisch ist.
  21. Hiermit wird die Erlaubnis erteilt, wie unter den vorgenannten
  22. Bedingungen f"ur ver"anderte Versionen "Ubersetzungen dieses Handbuches
  23. in eine andere Sprache zu erstellen und zu vertreiben, mit der
  24. Ausnahme, da"s dieser Genehmigungsvermerk in einer "Ubersetzung
  25. angegeben sein darf, welche von der Stiftung gebilligt wird.
  26. Jedwede Vorschl"age, Verbesserungen, Erweiterungen, Fehlerberichte,
  27. Geld- und Sachspenden, Programmierauftr"age usw. sind stets willkommen.
  28. Bitte senden Sie diese direkt an meine Email Adresse.  Wenn Sie dieses
  29. Werkzeug m"ogen, so w"urde ich mich sehr "uber eine Postkarte von Ihnen
  30. freuen!
  31.                                 \\\_''/'
  32. -------------------------oOO    (/o-o\)    OOo-------------------------
  33. Thomas Esken                o  (.  "  .)  o   Internet :
  34. Im Hagenfeld 84              \___) ~ (___/      <esken@uni-muenster.de>
  35. D-48147 Muenster; GERMANY                     Phone : (+49) 0251 232585
  36. File: gcal-de.info,  Node: Top,  Next: Einleitung,  Prev: (dir),  Up: (dir)
  37. Gcal ist ein Programm um Kalender auszugeben.  Gcal gibt Monatskalender
  38. und Jahreskalender, ewige Feiertagslisten sowie Terminwarnungslisten
  39. auf viele verschiedene Arten und Weisen aus.  Es ber"ucksichtigt
  40. diejenigen Daten korrekt, welche "ubergangen wurden, als der derzeitig
  41. g"ultige Gregorianische Kalender den vormals g"ultigen Julianischen
  42. Kalender abl"oste.
  43. Das ist die Ausgabe 0.24 der Gcal Dokumentation vom 20 Dezember 1995,
  44. f"ur Gcal 0.39.
  45. Jedwede Vorschl"age, Verbesserungen, Erweiterungen, Fehlerberichte,
  46. Geld- und Sachspenden, Programmierauftr"age usw. sind stets willkommen.
  47. Bitte senden Sie diese direkt an meine Email Adresse.  Wenn Sie dieses
  48. Werkzeug m"ogen, so w"urde ich mich sehr "uber eine Postkarte von Ihnen
  49. freuen!
  50.                                 \\\_''/'
  51. -------------------------oOO    (/o-o\)    OOo-------------------------
  52. Thomas Esken                o  (.  "  .)  o   Internet :
  53. Im Hagenfeld 84              \___) ~ (___/      <esken@uni-muenster.de>
  54. D-48147 Muenster; GERMANY                     Phone : (+49) 0251 232585
  55. * Menu:
  56. * Einleitung::          Einf"uhrung in Gcal.
  57. * Aufruf von Gcal::     Wie starte ich das `gcal' Programm?
  58. * Ewige Feiertage::     Wie wird eine Ewige Feiertagsliste erzeugt?
  59. * Terminwarnungen::     Wie wird eine Terminwarnungsliste erzeugt?
  60. Anh"ange
  61. * Heutiger Kalender::   Entstehungsgeschichte des Gregorianischen Kalenders.
  62. * Metasymbole::         In diesem Dokument benutzte Metasymbole.
  63. * Kodierschema::        Kodierschema des Datumteils einer Resourcendatei.
  64. * Umgebungsvariablen::  Ber"ucksichtigte Umgebungsvariablen.
  65. * Fehlerkodes::         Welche Fehlerkodes werden von Gcal zur"uckgegeben?
  66. Indizes
  67. * Argumentenindex::     Verzeichnis der Kommandozeilenargumente.
  68. * Variablenindex::      Verzeichnis der Umgebungsvariablen.
  69. * Begriffsindex::       Stichwortverzeichnis.
  70.   --- Detaillierte Aufstellung Von Knoten ---
  71. Aufruf von Gcal
  72. * Kommandozeilenargumente::     Kommandozeilenargumente.
  73. * Die GCAL Umgebungsvariable::  Wie wird die `GCAL' Umgebungsvariable benutzt?
  74. Kommandozeilenargumente
  75. * Optionen::           Wie werden Optionen benutzt?
  76. * Antwortdatei::       Wie wird eine `@DATEI' Antwortdatei benutzt?
  77. * Datummodifizierer::  Wie wird der `%DATUM' Datummodifizierer benutzt?
  78. * Kommandos::          Wie werden Kommandos benutzt?
  79. Optionen
  80. * Allgemeine Optionen::      Wie Allgemeine Optionen benutzt werden.
  81. * Globale Optionen::         Wie Globale Optionen benutzt werden.
  82. * Kalender Optionen::        Wie Kalender Optionen benutzt werden.
  83. * Terminwarnungs Optionen::  Wie Terminwarnungs Optionen benutzt werden.
  84. Kommandos
  85. * Einfache Kommandos::       Wie ein Einfaches Kommando benutzt wird.
  86. * 3-Monatsmodus Kommandos::  Wie ein 3-Monatsmodus Kommando benutzt wird.
  87. * Kommandolisten::           Wie eine Liste von Kommandos benutzt wird.
  88. * Kommandobereiche::         Wie ein Bereich von Kommandos benutzt wird.
  89. Ewige Feiertage
  90. * Resourcendatei::           Wie eine Resourcendatei benutzt wird.
  91. * Resourcendateibeispiele::  Beispiele zu Eintr"agen in der Resourcendatei.
  92. Resourcendatei
  93. * Struktur einer Resourcendatei::  Wie wird eine Resourcendatei erstellt?
  94. * Datumteil einer Zeile::          Wie mu"s der Datumteil aussehen?
  95. * Textteil einer Zeile::           Wie mu"s der Textteil aussehen?
  96. * Zeile kommentieren::             Wie eine Zeile kommentiert werden kann.
  97. * Include Anweisungen::            Was sind Include Anweisungen?
  98. * Spezielle Textmakros::           Was sind Spezielle Textmakros?
  99. * Datumvariablen::                 Wie Datumvariablen benutzt werden k"onnen.
  100. Spezielle Textmakros
  101. * %s Textmakro::  Wie ein Start eines Termins Textmakro benutzt wird.
  102. * %e Textmakro::  Wie ein Ende eines Termins Textmakro benutzt wird.
  103. * %b Textmakro::  Wie ein Geburtstags Textmakro benutzt wird.
  104. * %y Textmakro::  Wie ein Jahreszahl Textmakro benutzt wird.
  105. * %m Textmakro::  Wie ein Monatszahl Textmakro benutzt wird.
  106. * %w Textmakro::  Wie ein Wochenzahl Textmakro benutzt wird.
  107. * %d Textmakro::  Wie ein Tageszahl Textmakro benutzt wird.
  108. * %n Textmakro::  Wie ein Datumtext Textmakro benutzt wird.
  109. * %t Textmakro::  Wie ein Aktuelle Uhrzeit Textmakro benutzt wird.
  110. Kodierschema
  111. * Kodierschema Tabelle 1::
  112. * Kodierschema Tabelle 2::
  113. File: gcal-de.info,  Node: Einleitung,  Next: Aufruf von Gcal,  Prev: Top,  Up: Top
  114. Einleitung
  115. **********
  116. Neben den "ublichen und altbekannten Kalenderfunktionen wie der Ausgabe
  117. eines Monatskalenderblatts oder eines Jahreskalenderblatts, oder der
  118. Ausgabe einer ewigen Feiertagsliste bietet Gcal die M"oglichkeit,
  119. Termine am Tag ihres Auftretens auszugeben, und so den Benutzer auf
  120. einen Termin hinzuweisen.  So ist es vorstellbar, da"s beim Starten des
  121. Computers oder der Arbeitssitzung dem Benutzer von Gcal alle Termine,
  122. welche an diesem Tag wahrzunehmen sind, am Bildschirm aufgezeigt oder
  123. via elektronischer Post zugesandt werden.
  124. Der Zeitraum, f"ur welchen Gcal anfallende Termine ber"ucksichtigt,
  125. kann vom Benutzer frei vorgew"ahlt werden.  So k"onnen Termine, die
  126. sich z.B. auf den morgigen Tag beziehen, ebenso wie Termine, die in der
  127. gesamte Woche, dem gesamten Monat oder dem gesamten Jahr auftreten, von
  128. Gcal ausgegeben werden.  Termine, die an einem bestimmten Tag des
  129. Jahres auftreten, werden ebenso wie Termine, die relativ zu einem
  130. anderen, vorgegebenen Datum auftreten, von Gcal ausgegeben; entweder
  131. nur bezogen auf dieses Einzeldatum oder als Terminliste beginnend bei
  132. einem Startdatum und endend (einschliesslich oder ausschliesslich) am
  133. aktuellen Tag.
  134. Es bestehen zwei M"oglichkeiten, eine Terminvorschau (Termine
  135. zuk"unfiger Jahre) oder eine Terminr"uckschau (Termine vergangener
  136. Jahre) vorzunehmen.  So kann Gcal einerseits mittels einer Option,
  137. welche da"s vom Computer gelieferte aktuelle Systemdatum f"ur den
  138. Augenblick des Gcal-Programmlaufs auf ein vorgegebenes Datum setzt,
  139. verwendet werden, um eine Terminvorschau bzw.  Terminr"uckschau so
  140. vorzunehmen, als wenn das Systemdatum tats"achlich eben dieses
  141. vorgegebene Datum w"are, so da"s der zu ber"ucksichtigende Zeitraum via
  142. Option vom Benutzer beliebig vorgegeben werden kann.  Andererseits kann
  143. mittels eines Kommandos veranla"st werden, anstelle des aktuellen
  144. Jahres ein anderes Jahr zu ber"ucksichtigen, so da"s Gcal anfallende
  145. Termine f"ur eben dieses andere Jahr ausgibt.  Das hat allerdings zur
  146. Folge, da"s der vorgew"ahlte Zeitraum nicht mehr via Option vom
  147. Benutzer beliebig gesetzt werden kann, sondern sich in diesem Fall
  148. stets auf das gesamte Jahr bezieht.
  149. Gcal vermag nicht nur Termine auszugeben, die f"ur ein konkretes Datum
  150. gespeichert wurden, z.B. `Termin am 1'ten Dezember 1995', sondern auch
  151. Termine, die in bestimmten Abst"anden immer wieder auftreten.  So ist es
  152. m"oglich, wiederkehrende Termine wie z.B. `Dieser Termin findet an
  153. allen Tagen im Monat Mai 1995 statt' oder `Immer am 15'ten November
  154. eines jeden Jahres' zu vereinbaren.  Diese Terminvereinbarungen werden
  155. in sogenannten Resourcendateien gespeichert, und bei Programmaufruf
  156. kann Gcal via Option mitgeteilt werden, welche Resourcendateien
  157. auszuwerten sind.
  158. Einmal f"ur sinnvoll erachtete Aufrufe von Gcal k"onnen hinsichtlich
  159. der an das Programm "ubergebenen Kommandozeilenargumente dauerhaft in
  160. einer sogenannten Antwortdatei oder in einer shell script Datei
  161. gespeichert werden.  Eine Antwortdatei enth"alt ebenso wie eine shell
  162. script Datei alle Argumente, die an Gcal zur Verarbeitung "ubergeben
  163. wurden, nur ist eine solche Antwortdatei nicht eigenst"andig
  164. ablauff"ahig.  Wenn bei einem erneuten Aufruf von Gcal der Name dieser
  165. automatisch erzeugten Antwortdatei via Option "ubergeben wird, so liest
  166. Gcal den Inhalt dieser Antwortdatei ein und behandelt diesen so, als
  167. wenn dieser in der Kommandozeile angegeben w"are.  Im Gegensatz dazu
  168. wird bei Aufruf einer shell script Datei das Gcal Programm direkt mit
  169. den in der shell script Datei gespeicherten Argumeten sowie den
  170. zus"atzlich in der Kommandozeile angegebenen Argumenten ausf"uhrt.
  171. Um einen konkreten Eindruck von den weiteren M"oglichkeiten des Gcal
  172. Programms zu erhalten, werden nun alle verwendbaren
  173. Kommandozeilenargumente sowie deren Bedeutung vorgestellt.
  174. File: gcal-de.info,  Node: Aufruf von Gcal,  Next: Ewige Feiertage,  Prev: Einleitung,  Up: Top
  175. Aufruf von Gcal
  176. ***************
  177. Gcal ist ein kommandozeilenorientiertes Programm.  Es wird
  178. "ublicherweise vom Kommandointerpretierer des Betriebssystems aus
  179. aufgerufen (auch als "Shell" bezeichnet; dieses Betriebssystemsprogramm
  180. interpretiert Komandozeilen und f"uhrt diese aus), und verarbeitet die
  181. ihm "ubergebenen Argumente, welche Optionen und Kommandos sind.
  182. Optionen m"ussen vor Kommandos angegeben werden, d.h. Gcal mu"s auf
  183. folgende Art und Weise aufgerufen werden:
  184.      gcal [ [Option...] [%Datum] [@Datei...] ]  [Kommando]
  185. Wenn Gcal ohne entsprechende Optionen aufgerufen wird bzw. kein Kommando
  186. angegeben wird, so wird ein Kalender des laufenden Monats ausgegeben.
  187. Wenn der Kalender eines bestimmten Jahres ausgegeben werden soll, so
  188. mu"s das Jahr vollst"andig angegeben werden, z.B. `gcal 94' w"urde
  189. nicht den Jahreskalender von 1994 ausgeben, sondern den Jahreskalender
  190. des Jahres 94.
  191. Werden zwei Argumente als Kommando angegeben, so bezieht sich das
  192. *erste* Argument auf den Monat und das *zweite* Argument auf das Jahr.
  193. Werden beim Aufruf inkorrekte Kommandos angegeben, so wird die
  194. Programmausf"uhrung unter Benutzung interner Grundeinstellungen von
  195. Gcal vorgenommen.
  196. * Menu:
  197. * Kommandozeilenargumente::     Kommandozeilenargumente.
  198. * Die GCAL Umgebungsvariable::  Wie wird die `GCAL' Umgebungsvariable benutzt?
  199. File: gcal-de.info,  Node: Kommandozeilenargumente,  Next: Die GCAL Umgebungsvariable,  Prev: Aufruf von Gcal,  Up: Aufruf von Gcal
  200. Kommandozeilenargumente
  201. =======================
  202. Dieses Unterkapitel beschreibt alle Argumente der Kommandozeile, die von
  203. Gcal verarbeitet werden.  Es gibt insgesamt vier verschiedene Typen von
  204. Kommandozeilenargumenten.  Ein wichtiger Typ von Argumenten sind die
  205. "Optionen", welche verschiedene Verhaltensweisen bei Gcal ausl"osen.
  206. Andere Argumenttypen sind die `%DATUM' und die `@DATEI' Option.  Die
  207. `%DATUM' Option setzt den Zeitraum, welcher von Gcal ber"ucksichtigt
  208. werden soll, auf ein vorbestimmtes Startdatum; die `@DATEI' Option
  209. l"adt Optionen und Kommandos aus einer Antwortdatei vor.  Die
  210. wichtigsten Argumente sind die "Kommandos", welche die Zeitr"aume
  211. kontrollieren, die von Gcal ber"ucksichtigt werden.
  212. Eine Option wird durch ein f"uhrendes Umschaltzeichen (auch "Switch"
  213. Zeichen genannt) definiert; entweder das `-' oder das `/' Zeichen bei
  214. traditionellen Kurzoptionen, oder zwei `--' bei den mnemotechnischen
  215. Langoptionen; einem Kommando darf kein Umschaltzeichen vorangehen.
  216. Optionen (inklusive `%DATUM' und `@DATEI') *m"ussen* vor Kommandos
  217. angegeben werden!
  218. Abh"angig vom benutzten Betriebssystem bzw. der Shell kann es sein, da"s
  219. einige der in der Kommandozeile gegebenen Argumente und Texte durch `"'
  220. oder `'' Zeichen quotiert, bzw. durch das `\' Zeichen gegen die
  221. Auswertung durch die Shell gesch"utzt werden m"ussen.
  222. Diese Zeichen k"onnten sein:
  223.      ( ) < > [ ] { } \ | $ @ ! & ~ " ' ` ;
  224. * Menu:
  225. * Optionen::           Wie werden Optionen benutzt?
  226. * Antwortdatei::       Wie wird eine `@DATEI' Antwortdatei benutzt?
  227. * Datummodifizierer::  Wie wird der `%DATUM' Datummodifizierer benutzt?
  228. * Kommandos::          Wie werden Kommandos benutzt?
  229. File: gcal-de.info,  Node: Optionen,  Next: Antwortdatei,  Prev: Kommandozeilenargumente,  Up: Kommandozeilenargumente
  230. Optionen
  231. --------
  232. Die Optionen, welche von Gcal verarbeitet werden, k"onnen in vier
  233. Hauptklassen unterteilt werden.  Die Optionen der "Allgemeinen
  234. Optionsklasse" sind die Standardoptionen, welche jede GNU Software
  235. aufweisen sollte.  Die "Globale Optionsklasse" enth"alt Optionen,
  236. welche die vom Programm erzeugte Ausgabe beeinflussen.  Die Optionen der
  237. "Kalender Optionsklasse" steuern das Kalender Layout und die Optionen
  238. der "Terminwarnungs Optionsklasse" kontrollieren das Layout der
  239. Terminwarnungen und deren Intensit"at.
  240. Gcal ist in der Lage Kurzoptionen sowie auch GNU Langoptionen zu
  241. verarbeiten.  Kurzoptionen werden von einem einzelnen Umschaltzeichen
  242. angef"uhrt, sodann folgt ein Optionszeichen und evtl. ein Modifizierer
  243. oder ein Argument.  GNU Langoptionen werden von `--' Zeichen
  244. angef"uhrt, sodann folgt ein Optionsname und evtl. ein Argument.
  245. Langoptionen sowie deren Argumente d"urfen abgek"urzt werden, wenn die
  246. vorgenommene Abk"urzung eindeutig ist.  Wenn ein Argument an eine
  247. Langoption "ubergeben werden soll, so werden der Optionsname und das
  248. Argument mit einem `=' Zeichen verbunden.  Gcal verarbeitet GNU
  249. Langoptionen in einem besonderen, nicht standardgem"a"sen Weg.
  250. So unterscheidet Gcal vier verschiedene Typen von Langoptionen:
  251.   1. `--foo'
  252.      Schaltet die `--foo' Option an.
  253.   2. `--foo=BAR'
  254.      Schaltet die `--foo' Option mit dem ben"otigtem BAR Argument an.
  255.   3. `--foo[=BAR[|...|BAR]]'
  256.      Die `--foo' Option darf ein BAR Argument annehmen.  Falls keine
  257.      Argumentliste gegeben ist, so darf diese Option jedes Argument
  258.      annehmen.  Wenn aber doch eine Argumentliste gegeben ist, so darf
  259.      diese Option genau ein Argument aus der gegebenen Liste annehmen.
  260.      Falls in dieser Hinsicht kein Argument angew"ahlt wird, so wird
  261.      automatisch das erste BAR Argument aus der Argumentliste
  262.      angenommen.
  263.   4. `--foo=BAR|...|BAR'
  264.      Die `--foo' Option mu"s genau ein BAR Argument annehmen, welches
  265.      aus der gegebenen Argumentliste angew"ahlt werden mu"s.
  266. Traditionelle Kurzoptionen unterscheiden sich wie folgt:
  267.   1. `-x'
  268.      Schaltet die `-x' Option an.
  269.   2. `-x BAR'
  270.      Schaltet die `-x' Option mit dem ben"otigtem BAR Argument an.  Das
  271.      BAR Argument darf durch ein f"uhrendes *whitespace* Zeichen von dem
  272.      Kurzoptionszeichen `x' abgegrenzt werden.  Das bedeutet, da"s
  273.      folgende Notationen zur Angabe eines Arguments verwendet werden
  274.      k"onnen, n"amlich `-x BAR' und `-xBAR'.
  275.   3. `-x[BAR|...|BAR]'
  276.      Die `-x' Option darf einen oder mehrere BAR "Modifizierer"
  277.      annehmen.  Modifizierer in diesem Sinne sind ein oder mehrere
  278.      Zeichen, welche einen speziellen Modus definieren, der durch die
  279.      `-x' Option ausgel"ost wird.  Ein Modifizierer darf nicht durch
  280.      ein f"uhrendes *whitespace* Zeichen vom Kurzoptionszeichen
  281.      abgegrenzt werden.
  282. * Menu:
  283. * Allgemeine Optionen::      Wie Allgemeine Optionen benutzt werden.
  284. * Globale Optionen::         Wie Globale Optionen benutzt werden.
  285. * Kalender Optionen::        Wie Kalender Optionen benutzt werden.
  286. * Terminwarnungs Optionen::  Wie Terminwarnungs Optionen benutzt werden.
  287. File: gcal-de.info,  Node: Allgemeine Optionen,  Next: Globale Optionen,  Prev: Optionen,  Up: Optionen
  288. Allgemeine Optionen
  289. ...................
  290. `--help'
  291.      Ausgabe eines verdichteten Hilfetextes, welcher die meisten aller
  292.      verf"ugbaren Optionen aufzeigt; sodann erfolgreiche Beendigung des
  293.      Programms.
  294. `-??'
  295. `-hh'
  296. `--usage[=ARG]'
  297. `--long-help[=ARG]'
  298.      Ausgabe eines erweiterten Hilfetextes, welcher alle verf"ugbaren
  299.      Optionen aufzeigt; sodann erfolgreiche Beendigung des Programms.
  300.      Falls ARG angegeben wird und ein zul"assiger Langoptionsname ist,
  301.      so wird nur ein erweiterter Hilfetext zu dem angegebenen
  302.      Langoptionsnamen ausgegeben, z.B.:
  303.           --long-help=long-help
  304.      gibt einen erweiterten Hilfetext zur Langoption `--long-help' aus.
  305. `--license'
  306. `--copyleft'
  307. `--copyright'
  308.      Ausgabe des Software-Lizenztextes; sodann erfolgreiche Beendigung
  309.      des Programms.
  310. `--version'
  311.      Ausgabe der Versionsnummer und der Kompilations-Optionen; sodann
  312.      erfolgreiche Beendigung des Programms.
  313. File: gcal-de.info,  Node: Globale Optionen,  Next: Kalender Optionen,  Prev: Allgemeine Optionen,  Up: Optionen
  314. Globale Optionen
  315. ................
  316. `-R NAME'
  317. `--response-file=ARG'
  318.      Inhalt der Umgebungsvariablen `GCAL' (*note GCAL:
  319.      Umgebungsvariablen.), und sodann die Argumente der Kommandozeile
  320.      (in genau dieser Reihenfolge) in die Datei NAME schreiben, d.h.
  321.      Antwortdatei `name' erzeugen.  *Note Antwortdatei::, f"ur weitere
  322.      Details.
  323. `-S NAME'
  324. `--shell-script=ARG'
  325.      Inhalt der Umgebungsvariablen `GCAL' (*note GCAL:
  326.      Umgebungsvariablen.), und sodann die Argumente der Kommandozeile
  327.      (in genau dieser Reihenfolge) in die shell script Datei NAME
  328.      schreiben, d.h. shell script `name' erzeugen.  Eine automatisch
  329.      erzeugte shell script Datei ist eigenst"anding ablauff"ahig und
  330.      ruft Gcal direkt mit den im Script gespeicherten Argumenten auf.
  331.      Beim Aufruf der shell script Datei d"urfen weitere
  332.      Kommandozeilenargumente gegeben werden, welche dann zudem an Gcal
  333.      "ubermittelt werden.
  334. `--debug[=internal|handled|unhandled|all|abort]'
  335.      Einige Debug-Informationen ausgeben.
  336.     `--debug=internal'
  337.           Warnungen bei Erreichen programminterner Maxima ausgeben.
  338.     `--debug=handled'
  339.           Wie `--debug=internal', zudem werden die Dateinamen
  340.           ausgegeben, die gehandhabt werden.
  341.     `--debug=unhandled'
  342.           Wie `--debug=internal', zudem werden die Dateinamen
  343.           ausgegeben, die nicht gehandhabt werden.
  344.     `--debug=all'
  345.           Wie `--debug=handled' und `--debug=unhandled' zusammen.
  346.     `--debug=abort'
  347.           Wie `--debug=all', und Abbruch mit Fehlerkode beim ersten
  348.           Auftreten eines nicht gehandhabten Dateinamens; siehe *Note
  349.           118: Fehlerkodes.
  350. `--pager'
  351.      S"amtliche Ausgaben von Gcal entweder durch einen *externen*
  352.      Paginierer oder durch einen einfachen, *internen* Paginierer
  353.      lenken.  Falls eine `PAGER' Umgebungsvariable gesetzt ist, so wird
  354.      deren Wert zum Auffinden des externen Paginiererprogramms
  355.      ber"ucksichtigt.  *Note PAGER: Umgebungsvariablen, f"ur weitere
  356.      Informationen.
  357.      Falls keine `PAGER' Umgebungsvariable gesetzt ist oder aber deren
  358.      Wert ung"ultig ist, so versucht Gcal den `less' Paginierer zu
  359.      benutzen; falls dieses Programm aber w"ahrend des Absuchens des
  360.      Dateibaums unter Zuhilfenahme der `PATH' Umgebungsvariablen nicht
  361.      vorgefunden wird, so wird Gcal versuchen, das `more'
  362.      Paginiererprogramm in gleicher Weise aufzusp"uren (1).  *Note
  363.      PATH: Umgebungsvariablen.
  364.      Falls alle diese Aktionen versagt haben sollten, so wird Gcal einen
  365.      einfachen, eingebauten Paginierer benutzen.  Wenn der einfache,
  366.      interne Paginierer benutzt wird, so ermittelt Gcal die Anzahl der
  367.      Zeilen, welche vor einer Eingabeaufforderung des internen
  368.      Paginierers ausgegeben werden, nach folgenden Methoden:
  369.        1. Gcal benutzt die Werte, die in den Umgebungsvariablen `LINES'
  370.           und `COLUMNS' angegeben sind.  *Note LINES:
  371.           Umgebungsvariablen, und siehe auch *Note COLUMNS:
  372.           Umgebungsvariablen, f"ur weitere Details.
  373.        2. Falls vorherige Aktion versagt, so benutzt Gcal die Werte,
  374.           die in den Umgebungsvariablen `LI' und `CO' angegeben sind.
  375.           *Note LI: Umgebungsvariablen, und siehe auch *Note CO:
  376.           Umgebungsvariablen, f"ur weitere Details.
  377.        3. Falls vorherige Aktion versagt, so benutzt Gcal eine
  378.           systemabh"angige *low-level* Funktion und benutzt die Werte,
  379.           die von dieser geliefert werden.
  380.        4. Falls vorherige Aktion versagt, so benutzt Gcal die Werte,
  381.           die in der `termcap' (2) Datei f"ur das verwendete
  382.           Sichtger"at vorgefunden werden (*note TERM:
  383.           Umgebungsvariablen.).  Dieser Schritt wird nur auf Systemen
  384.           ausgef"uhrt, welche die Benutzung von Termcap unterst"utzen.
  385.        5. Falls alle vorherigen Aktionen fehlschlagen, so benutzt Gcal
  386.           Standardwerte (entweder 23 oder 24 Zeilen, 80 Spalten).
  387. `-H yes'
  388. `--force-highlighting'
  389. `--highlighting=yes'
  390.      Falls die Ausgabe des Programms "redirektioniert" (d.h. auf einen
  391.      anderen Ger"atekanal umgelenkt) wird oder in einer "pipe" (d.h. als
  392.      Eingabedatenstrom f"ur ein weiteres Programm dient) benutzt wird,
  393.      so werden Hervorhebungssequenzen *nicht* automatisch in die
  394.      entsprechenden Markierungszeichen umgesetzt, sondern unver"andert
  395.      ausgegeben.
  396. `-H no'
  397. `--disable-highlighting'
  398. `--highlighting=no'
  399.      Hervorhebungsequenz-/ Markierungszeichen Paare von aktuellen
  400.      Tagen, Feiertagen bzw. Text unterdr"ucken.
  401. `-H TEXT'
  402. `--highlighting=ARG'
  403.      Setze Hervorhebungssequenz Markierungszeichen Paare explizit.
  404.      "Hervorhebungssequenzen" in diesem Sinne sind Folgen von
  405.      Steuerzeichen, die eine Farbumschaltung oder eine
  406.      Intensit"atsumschaltung von auszugebendem Text bewirken.  Typische
  407.      Steuerzeichenfolgen sind die sogenannten ANSI Escape-Sequenzen,
  408.      welche als erstes Zeichen der Sequenz ein Escape Zeichen
  409.      aufweisen, und danach weitere Zeichen, die die Art der ANSI
  410.      Escape-Sequenz definieren.  "Markierungszeichen" in diesem Sinne
  411.      sind einzelne druckbare Zeichen, die dem auszugebenden Text
  412.      vorangehen bzw. folgen.
  413.      Das Argument TEXT mu"s ein durch `:' (Doppelpunkt) Zeichen
  414.      abgegrenzter Text der Form
  415.      SEQ1_START:SEQ1_ENDE:SEQ2_START:SEQ2_ENDE sein.  Die *erste*
  416.      Sequenz wird dazu benutzt den aktuellen Tag hervorzuheben, die
  417.      *zweite* Sequenz hebt einen Feiertag hervor.  Die Sequenzen
  418.      m"ussen in der Form eines Sequenzen-Paares angegeben werden;
  419.      SEQ?_START schaltet die Hervorhebung/Markierung ein, SEQ?_ENDE
  420.      schaltet sie wieder aus.  Es werden stets nur zwei Sequenzen-Paare
  421.      ber"ucksichtigt, falls mehr Sequenzen-Paare angegeben sind, so
  422.      werden diese ignoriert.  Es d"urfen entweder nur
  423.      Hervorhebungssequenzen-Paare oder nur Markierungszeichen-Paare
  424.      definiert werden, d.h. eine gemischte Verwendung beider
  425.      Hervorhebungsarten ist nicht erlaubt!
  426.      Einige Beispiele hierzu:
  427.           `-H \x20:\x20:\x1:#' bzw.
  428.           `--highlighting=\x20:\x20:\x1:#'
  429.           markiert den aktuellen Tag in der Form `\x20TAGESDATUM\x20'
  430.           (d.h. mit vorangehenden und nachfolgenden Leerzeichen) und
  431.           Feiertage in der Form `\x1FEIERTAGSDATUM#' mit den gegebenen
  432.           Markierungszeichen.
  433.           `-H \x1b[34;42m:\x1b[0;40m' oder
  434.           `-H \033[34;42m:\033[0;40m' oder
  435.           `-H \E[34;42m:\E[0;40m'
  436.           definiert zum Hervorheben des aktuellen Tages die hier
  437.           angegebene ANSI Escape-Startsequenz `\x1b[34;42m' und die
  438.           ANSI Escape-Endesequenz `\x1b[0;40m'.  Da keine
  439.           Hervorhebungssequenzen f"ur den Feiertag angegeben sind,
  440.           werden die internen Grundeinstellungen der
  441.           Hervorhebungssequenzen f"ur diesen verwendet.  Bitte beachten
  442.           Sie in diesem Zusammenhang den letzten Absatz in diesem
  443.           Textteil, welcher "uber weitere Details informiert. *Note
  444.           GCALANSI: Umgebungsvariablen.
  445.      Steuerzeichensequenzen d"urfen jedes druckbare Zeichen enthalten.
  446.      Nichtdruckbare Zeichen k"onnen oktal oder hexadezimal kodiert
  447.      werden.  Die Abk"urzung `\E' kodiert direkt das Escape Zeichen
  448.      (oktal `\033' bzw. hexadezimal `\x1B').
  449.      Ein Zeichen kann durch `\NNN' (Backslash-Oktalziffer(n)) oktal
  450.      kodiert werden, wobei N eine g"ultige Oktalziffer (0...7) sein
  451.      mu"s.  Normalerweise m"ussen drei Oktalziffern angegeben werden.
  452.      Falls der oktale Zeichenkode nur aus einer oder zwei Oktalziffern
  453.      besteht, so m"ussen f"uhrende Nullen hinzugef"ugt werden;
  454.      ausgenommen, das kodierte Oktalzeichen wird zuletzt in einer
  455.      Einzelsequenz angegeben.
  456.      Ein Zeichen kann durch `\xNN' (Backslash-x-Hexadezimalziffer(n))
  457.      hexadezimal kodiert werden, wobei N eine g"ultige Hexadezimalziffer
  458.      (0...9A...Fa...f) sein mu"s.  Normalerweise m"ussen zwei
  459.      Hexadezimalziffern angegeben werden.  Falls der hexadezimale
  460.      Zeichenkode nur aus einer Hexadezimalziffer besteht, so mu"s eine
  461.      f"uhrende Null hinzugef"ugt werden; ausgenommen, das kodierte
  462.      Hexadezimalzeichen wird zuletzt in einer Einzelsequenz angegeben.
  463.      Falls das Sequenzen-Trennzeichen, das `:' (Doppelpunkt) Zeichen
  464.      selbst als Markierungszeichen benutzt werden soll, so mu"s dieses
  465.      Zeichen entweder oktal `\072' oder hexadezimal `\x3A' kodiert
  466.      werden.
  467.      Falls das C Preprocessorsymbol USE_PAGER definiert wurde, und die
  468.      Ausgabe des Programms redirektioniert wird oder in einer pipe
  469.      steht, so werden Hervorhebungssequenzen automatisch in die
  470.      entsprechenden Markierungszeichen umgesetzt; falls USE_PAGER nicht
  471.      definiert wurde, so bleiben Hervorhebungssequenzen unver"andert.
  472.      Unvollst"andig oder garnicht angegebene Hervorhebungssequenzen
  473.      werden durch intern fest voreingestellte ANSI
  474.      Escape-Hervorhebungssequenzen ersetzt, falls eine `GCALANSI'
  475.      Umgebungsvariable definiert ist; anderenfalls vollst"andig durch
  476.      deren entsprechende Markierungszeichen ersetzt.  *Note GCALANSI:
  477.      Umgebungsvariablen.
  478. `-m ADR'
  479. `--mail=ARG'
  480.      Versenden von Gcal's Ausgabe via `mail' (3) Programm an die Email
  481.      Adresse ADR, z.B.:
  482.           --mail=root
  483.           -m esken@uni-muenster.de
  484.   ---------- Footnotes ----------
  485.   (1)  Beachten Sie die Standard-Handbuchseiten (*man*) zu `less' und
  486. `more'.
  487.   (2)  Beachten Sie die Standard-Handbuchseiten (*man*) zu Termcap.
  488.   (3)  Beachten Sie die Standard Handbuchseiten (*man*) zu `mail'.
  489. File: gcal-de.info,  Node: Kalender Optionen,  Next: Terminwarnungs Optionen,  Prev: Globale Optionen,  Up: Optionen
  490. Kalender Optionen
  491. .................
  492. `-n|N[-]'
  493. `--descending-holiday-list[=long|short]'
  494. `--holiday-list[=long|short]'
  495.      Ausgabe einer ewigen Feiertagsliste.  *Note Ewige Feiertage::, f"ur
  496.      zus"atzliche Informationen.
  497.     `-n'
  498.     `--holiday-list=long'
  499.           Aufsteigend sortierte Ausgabe der ewigen Feiertagsliste mit
  500.           allen Feiertagen.
  501.     `-n-'
  502.     `--descending-holiday-list=long'
  503.           Absteigend sortierte Ausgabe der ewigen Feiertagsliste mit
  504.           allen Feiertagen.
  505.     `-N'
  506.     `--holiday-list=short'
  507.           Aufsteigend sortierte Ausgabe der ewigen Feiertagsliste mit
  508.           nur den gesetzlichen Feiertagen.
  509.     `-N-'
  510.     `--descending-holiday-list=short'
  511.           Absteigend sortierte Ausgabe der ewigen Feiertagsliste mit
  512.           nur den gesetzlichen Feiertagen.
  513. `--exclude-holiday-list-title'
  514.      Ausgabe der "Uberschrift in der ewigen Feiertagsliste
  515.      unterdr"ucken.
  516. `-i[-]'
  517. `--type=special|standard'
  518.      Um das "Standard" Kalenderformat zu erhalten, so sollte Gcal
  519.      entweder ganz ohne die `-i[-]' Option aufgerufen werden, da diese
  520.      voreingestellt ist, oder aber um die Ausgabe eines Kalenderblatts
  521.      zu erzwingen, mit der `-i-' bzw. `--type=standard' Option
  522.      aufgerufen werden:
  523.           % gcal -i-
  524.           
  525.            September 1994
  526.           
  527.            Montag           5 12 19 26
  528.            Dienstag         6 13 20 27
  529.            Mittwoch         7 14 21 28
  530.            Donnerstag    1  8 15 22 29
  531.            Freitag       2  9 16 23 30
  532.            Samstag       3 10 17 24
  533.            Sonntag       4 11 18 25
  534.      Um das "Spezielle" Kalenderformat zu erhalten ("ahnlich dem
  535.      BSD-`cal' Programm), so sollte Gcal mit der Option `-i' bzw. mit
  536.      der Option `--type=special' gestartet werden (auch hier wird die
  537.      Ausgabe eine Kalenderblatts erzwungen):
  538.           % gcal -i
  539.           
  540.               September 1994
  541.            Mo Di Mi Do Fr Sa So
  542.                      1  2  3  4
  543.             5  6  7  8  9 10 11
  544.            12 13 14 15 16 17 18
  545.            19 20 21 22 23 24 25
  546.            26 27 28 29 30
  547. `--suppress-calendar'
  548.      Ausgabe eines Kalenderblatts explizit unterdr"ucken.
  549. `-b ANZAHL'
  550. `--blocks=ARG'
  551.      Setzen der Blockanzahl, in der ein Jahreskalender ausgegeben wird
  552.      (Zul"assige Argumente: `1|2|3|4|6|12').  Der voreingestellte Wert
  553.      ist beim *Standard* Kalenderformat `-b 3' bzw.  `--blocks=3', und
  554.      beim *Speziellen* Kalenderformat `-b 4' bzw. `--blocks=4'.  Falls
  555.      diese Option vorgefunden wird, so impliziert das Programm, da"s
  556.      die Ausgabe eines Jahreskalendes gew"unscht wird!
  557.     `-b 1'
  558.     `--blocks=1'
  559.           Gibt einen Block mit allen zw"olf Monaten aus.
  560.     `-b 2'
  561.     `--blocks=2'
  562.           Gibt zwei Bl"ocke mit je sechs Monaten aus.
  563.     `-b 3'
  564.     `--blocks=3'
  565.           Gibt drei Bl"ocke mit je vier Monaten aus.
  566.     `-b 4'
  567.     `--blocks=4'
  568.           Gibt vier Bl"ocke mit je drei Monaten aus.
  569.     `-b 6'
  570.     `--blocks=6'
  571.           Gibt sechs Bl"ocke mit je zwei Monaten aus.
  572.     `-b 12'
  573.     `--blocks=12'
  574.           Gibt zw"olf Bl"ocke mit je einem Monat aus.
  575. `-j[b]'
  576. `--calendar-dates=julian|both'
  577.      Benutze alternatives Datumformat im Kalenderblatt.
  578.     `-j'
  579.     `--calendar-dates=julian'
  580.           Ausgabe des Kalenderblatts im Julianischen Datumformat.
  581.     `-jb'
  582.     `--calendar-dates=both'
  583.           Ausgabe des Kalenderblatts im Standard- und Julianischen
  584.           Datumformat.
  585. `-jn[b]'
  586. `--holiday-dates=julian|both'
  587.      Benutze alternatives Datumformat in ewiger Feiertagsliste.  *Note
  588.      `--holiday-list[=long|short]': Kalender Optionen.
  589.     `-jn'
  590.     `--holiday-dates=julian'
  591.           Ausgabe der ewige Feiertagsliste im Julianischen Datumformat.
  592.     `-jnb'
  593.     `--holiday-dates=both'
  594.           Ausgabe der ewige Feiertagsliste im Standard- und
  595.           Julianischen Datumformat.
  596. `-jc[b]'
  597. `--fixed-dates=julian|both'
  598.      Benutze alternatives Datumformat in Terminwarnungsliste.  *Note
  599.      `--list-of-fixed-dates[=short|long]': Terminwarnungs Optionen.
  600.     `-jc'
  601.     `--fixed-dates=julian'
  602.           Ausgabe der Terminwarnungsliste im Julianischen Datumformat.
  603.     `-jcb'
  604.     `--fixed-dates=both'
  605.           Ausgabe der Terminwarnungsliste im Standard- und Julianischen
  606.           Datumformat.
  607. `-s ARG'
  608. `--starting-day=ARG'
  609.      Setzen des Starttags der Woche (Zul"assige Argumente:
  610.      `0, 1...7 | WOCHENTAGSNAME').
  611.      Zum Beispiel:
  612.           --starting-day=7 oder
  613.           -s 7 oder
  614.           -s So oder
  615.           -s sonnt oder
  616.           -s SONNTAG
  617.      bezeichnet den Sonntag (1==Mo, 2==Di ... 7==So).
  618.      Wenn die `-s 0' Option bzw. die `--starting-day=0' Option
  619.      vorgefunden wird, so wird der Starttag der Woche auf den gerade
  620.      aktuellen Wochentag gesetzt.
  621.